SetWindowProxyIcon

SetWindowProxyIcon
Header:	MacWindows.h		Carbon status:	Supported

Overrides the default proxy icon for a window.

OSStatus SetWindowProxyIcon (
    WindowRef window, 
    IconRef icon
);

window: A pointer to the window for which you wish to set the proxy icon.
icon: An icon reference identifying the icon to be used for the window’s proxy icon. If there is already a proxy icon in use of the type desired, an IconRef value may be obtained for that icon by calling the function GetWindowProxyIcon. Otherwise, your application must call the Icon Services function GetIconRefFromFile to get a value of type IconRef.

function result: A result code.

DISCUSSION

If you wish to override the proxy icon that the Window Manager displays by default for a given file, your application should call the SetWindowProxyIcon function.

More typically, when you do not wish to override a window’s default proxy icon, your application would call one of the following functions: SetWindowProxyFSSpec, SetWindowProxyAlias, or SetWindowProxyCreatorAndType.

With Mac OS 8.5, you must save and restore the current graphics port—by calling the QuickDraw functions GetPort and SetPort—around each call to the SetWindowProxyIcon function.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.